From cda81cc37272d557ec2971aeb78f46c416f3a42a Mon Sep 17 00:00:00 2001 From: "Panashe M. Fundira" Date: Mon, 27 Jun 2016 22:35:55 -0400 Subject: [PATCH] Update help for build to show number of jobs (#2805) --- src/bin/bench.rs | 2 +- src/bin/build.rs | 2 +- src/bin/doc.rs | 2 +- src/bin/install.rs | 2 +- src/bin/run.rs | 2 +- src/bin/rustc.rs | 2 +- src/bin/rustdoc.rs | 2 +- src/bin/test.rs | 2 +- src/doc/config.md | 2 +- src/etc/_cargo | 16 ++++++++-------- src/etc/man/cargo-bench.1 | 2 +- src/etc/man/cargo-build.1 | 2 +- src/etc/man/cargo-doc.1 | 2 +- src/etc/man/cargo-install.1 | 2 +- src/etc/man/cargo-run.1 | 2 +- src/etc/man/cargo-test.1 | 2 +- 16 files changed, 23 insertions(+), 23 deletions(-) diff --git a/src/bin/bench.rs b/src/bin/bench.rs index fc412ef1a..a86d79f2b 100644 --- a/src/bin/bench.rs +++ b/src/bin/bench.rs @@ -37,7 +37,7 @@ Options: --bench NAME Benchmark only the specified bench target --no-run Compile, but don't run benchmarks -p SPEC, --package SPEC ... Package to run benchmarks for - -j N, --jobs N The number of jobs to run in parallel + -j N, --jobs N The number of jobs to run in parallel (defaults to # of CPUs) --features FEATURES Space-separated list of features to also build --no-default-features Do not build the `default` feature --target TRIPLE Build for the target triple diff --git a/src/bin/build.rs b/src/bin/build.rs index 25d69440e..4fde3a32f 100644 --- a/src/bin/build.rs +++ b/src/bin/build.rs @@ -33,7 +33,7 @@ Usage: Options: -h, --help Print this message -p SPEC, --package SPEC ... Package to build - -j N, --jobs N The number of jobs to run in parallel + -j N, --jobs N The number of jobs to run in parallel (defaults to # of CPUs) --lib Build only this package's library --bin NAME Build only the specified binary --example NAME Build only the specified example diff --git a/src/bin/doc.rs b/src/bin/doc.rs index 37b5f6040..acc3b217d 100644 --- a/src/bin/doc.rs +++ b/src/bin/doc.rs @@ -31,7 +31,7 @@ Options: --open Opens the docs in a browser after the operation -p SPEC, --package SPEC ... Package to document --no-deps Don't build documentation for dependencies - -j N, --jobs N The number of jobs to run in parallel + -j N, --jobs N The number of jobs to run in parallel (defaults to # of CPUs) --lib Document only this package's library --bin NAME Document only the specified binary --release Build artifacts in release mode, with optimizations diff --git a/src/bin/install.rs b/src/bin/install.rs index 542237551..44353e4c7 100644 --- a/src/bin/install.rs +++ b/src/bin/install.rs @@ -45,7 +45,7 @@ Specifying what crate to install: Build and install options: -h, --help Print this message - -j N, --jobs N The number of jobs to run in parallel + -j N, --jobs N The number of jobs to run in parallel (defaults to # of CPUs) --features FEATURES Space-separated list of features to activate -f, --force Force overwriting existing crates or binaries --no-default-features Do not build the `default` feature diff --git a/src/bin/run.rs b/src/bin/run.rs index 7515eba5b..2f0d2026f 100644 --- a/src/bin/run.rs +++ b/src/bin/run.rs @@ -28,7 +28,7 @@ Options: -h, --help Print this message --bin NAME Name of the bin target to run --example NAME Name of the example target to run - -j N, --jobs N The number of jobs to run in parallel + -j N, --jobs N The number of jobs to run in parallel (defaults to # of CPUs) --release Build artifacts in release mode, with optimizations --features FEATURES Space-separated list of features to also build --no-default-features Do not build the `default` feature diff --git a/src/bin/rustc.rs b/src/bin/rustc.rs index 2c2e85053..e71fb7835 100644 --- a/src/bin/rustc.rs +++ b/src/bin/rustc.rs @@ -35,7 +35,7 @@ Usage: Options: -h, --help Print this message -p SPEC, --package SPEC The profile to compile for - -j N, --jobs N The number of jobs to run in parallel + -j N, --jobs N The number of jobs to run in parallel (defaults to # of CPUs) --lib Build only this package's library --bin NAME Build only the specified binary --example NAME Build only the specified example diff --git a/src/bin/rustdoc.rs b/src/bin/rustdoc.rs index 8ed63d991..17a05eb43 100644 --- a/src/bin/rustdoc.rs +++ b/src/bin/rustdoc.rs @@ -33,7 +33,7 @@ Options: -h, --help Print this message --open Opens the docs in a browser after the operation -p SPEC, --package SPEC Package to document - -j N, --jobs N The number of jobs to run in parallel + -j N, --jobs N The number of jobs to run in parallel (defaults to # of CPUs) --lib Build only this package's library --bin NAME Build only the specified binary --example NAME Build only the specified example diff --git a/src/bin/test.rs b/src/bin/test.rs index 2d4dca943..c35d1e7a9 100644 --- a/src/bin/test.rs +++ b/src/bin/test.rs @@ -41,7 +41,7 @@ Options: --bench NAME Test only the specified benchmark target --no-run Compile, but don't run tests -p SPEC, --package SPEC ... Package to run tests for - -j N, --jobs N The number of jobs to run in parallel + -j N, --jobs N The number of jobs to run in parallel (defaults to # of CPUs) --release Build artifacts in release mode, with optimizations --features FEATURES Space-separated list of features to also build --no-default-features Do not build the `default` feature diff --git a/src/doc/config.md b/src/doc/config.md index 9f193cc20..55b4d0efb 100644 --- a/src/doc/config.md +++ b/src/doc/config.md @@ -79,7 +79,7 @@ proxy = "..." # HTTP proxy to use for HTTP requests (defaults to none) timeout = 60000 # Timeout for each HTTP request, in milliseconds [build] -jobs = 1 # number of jobs to run by default (default to # cpus) +jobs = 1 # number of jobs to run by default (defaults to # of CPUs) rustc = "rustc" # the rust compiler tool rustdoc = "rustdoc" # the doc generator tool target = "triple" # build for the target triple diff --git a/src/etc/_cargo b/src/etc/_cargo index 529aa89f7..aee5c6b7e 100644 --- a/src/etc/_cargo +++ b/src/etc/_cargo @@ -21,7 +21,7 @@ case $state in _arguments \ '--features=[space separated feature list]' \ '(-h, --help)'{-h,--help}'[show help message]' \ - '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel]' \ + '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel (defaults to # of CPUs)]' \ "${command_scope_spec[@]}" \ '--manifest-path=[path to manifest]: :_files -/' \ '--no-default-features[do not build the default features]' \ @@ -37,7 +37,7 @@ case $state in _arguments \ '--features=[space separated feature list]' \ '(-h, --help)'{-h,--help}'[show help message]' \ - '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel]' \ + '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel (defaults to # of CPUs)]' \ "${command_scope_spec[@]}" \ '--manifest-path=[path to manifest]: :_files -/' \ '--no-default-features[do not build the default features]' \ @@ -65,7 +65,7 @@ case $state in _arguments \ '--features=[space separated feature list]' \ '(-h, --help)'{-h,--help}'[show help message]' \ - '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel]' \ + '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel (defaults to # of CPUs)]' \ '--manifest-path=[path to manifest]: :_files -/' \ '--no-deps[do not build docs for dependencies]' \ '--no-default-features[do not build the default features]' \ @@ -133,7 +133,7 @@ case $state in '--features=[space separated feature list]' \ '--git=[URL from which to install the crate]' \ '(-h, --help)'{-h,--help}'[show help message]' \ - '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel]' \ + '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel (defaults to # of CPUs)]' \ '--no-default-features[do not build the default features]' \ '--path=[local filesystem path to crate to install]' \ '(-q, --quiet)'{-q,--quiet}'[no output printed to stdout]' \ @@ -242,7 +242,7 @@ case $state in '--example=[name of the bin target]' \ '--features=[space separated feature list]' \ '(-h, --help)'{-h,--help}'[show help message]' \ - '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel]' \ + '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel (defaults to # of CPUs)]' \ '--manifest-path=[path to manifest]: :_files -/' \ '--bin=[name of the bin target]' \ '--no-default-features[do not build the default features]' \ @@ -259,7 +259,7 @@ case $state in '--color=:colorization option:(auto always never)' \ '--features=[features to compile for the package]' \ '(-h, --help)'{-h,--help}'[show help message]' \ - '(-j, --jobs)'{-j,--jobs}'=[number of jobs to run in parallel]' \ + '(-j, --jobs)'{-j,--jobs}'=[number of jobs to run in parallel (defaults to # of CPUs)]' \ '--manifest-path=[path to the manifest to fetch dependencies for]' \ '--no-default-features[do not compile default features for the package]' \ '(-p, --package)'{-p,--package}'=[profile to compile for]' \ @@ -276,7 +276,7 @@ case $state in '--color=:colorization option:(auto always never)' \ '--features=[space-separated list of features to also build]' \ '(-h, --help)'{-h,--help}'[show help message]' \ - '(-j, --jobs)'{-j,--jobs}'=[number of jobs to run in parallel]' \ + '(-j, --jobs)'{-j,--jobs}'=[number of jobs to run in parallel (defaults to # of CPUs)]' \ '--manifest-path=[path to the manifest to document]' \ '--no-default-features[do not build the `default` feature]' \ '--open[open the docs in a browser after the operation]' \ @@ -302,7 +302,7 @@ case $state in _arguments \ '--features=[space separated feature list]' \ '(-h, --help)'{-h,--help}'[show help message]' \ - '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel]' \ + '(-j, --jobs)'{-j,--jobs}'[number of jobs to run in parallel (defaults to # of CPUs)]' \ '--manifest-path=[path to manifest]: :_files -/' \ '--test=[test name]: :_test_names' \ '--no-default-features[do not build the default features]' \ diff --git a/src/etc/man/cargo-bench.1 b/src/etc/man/cargo-bench.1 index e88023050..d820d0916 100644 --- a/src/etc/man/cargo-bench.1 +++ b/src/etc/man/cargo-bench.1 @@ -69,7 +69,7 @@ Package to benchmarks for. .RE .TP .B \-j \f[I]IN\f[], \-\-jobs \f[I]IN\f[] -The number of jobs to run in parallel. +The number of jobs to run in parallel (defaults to # of CPUs). .RS .RE .TP diff --git a/src/etc/man/cargo-build.1 b/src/etc/man/cargo-build.1 index b3aefa316..9323dae75 100644 --- a/src/etc/man/cargo-build.1 +++ b/src/etc/man/cargo-build.1 @@ -33,7 +33,7 @@ Package to build. .RE .TP .B \-j \f[I]IN\f[], \-\-jobs \f[I]IN\f[] -The number of jobs to run in parallel. +The number of jobs to run in parallel (defaults to # of CPUs). .RS .RE .TP diff --git a/src/etc/man/cargo-doc.1 b/src/etc/man/cargo-doc.1 index f9fb352e1..941cd2b24 100644 --- a/src/etc/man/cargo-doc.1 +++ b/src/etc/man/cargo-doc.1 @@ -43,7 +43,7 @@ Don\[aq]t build documentation for dependencies. .RE .TP .B \-j \f[I]N\f[], \-\-jobs \f[I]N\f[] -The number of jobs to run in parallel. +The number of jobs to run in parallel (defaults to # of CPUs). .RS .RE .TP diff --git a/src/etc/man/cargo-install.1 b/src/etc/man/cargo-install.1 index 78bbff748..f4b7012b5 100644 --- a/src/etc/man/cargo-install.1 +++ b/src/etc/man/cargo-install.1 @@ -89,7 +89,7 @@ Print this message. .RE .TP .B \-j \f[I]N\f[], \-\-jobs \f[I]N\f[] -The number of jobs to run in parallel. +The number of jobs to run in parallel (defaults to # of CPUs). .RS .RE .TP diff --git a/src/etc/man/cargo-run.1 b/src/etc/man/cargo-run.1 index 4783e060c..7a463a090 100644 --- a/src/etc/man/cargo-run.1 +++ b/src/etc/man/cargo-run.1 @@ -37,7 +37,7 @@ Name of the example target to run. .RE .TP .B \-j \f[I]IN\f[], \-\-jobs \f[I]IN\f[] -The number of jobs to run in parallel. +The number of jobs to run in parallel (defaults to # of CPUs). .RS .RE .TP diff --git a/src/etc/man/cargo-test.1 b/src/etc/man/cargo-test.1 index a8c305f98..fac6e2137 100644 --- a/src/etc/man/cargo-test.1 +++ b/src/etc/man/cargo-test.1 @@ -88,7 +88,7 @@ Package to run tests for. .RE .TP .B \-j \f[I]IN\f[], \-\-jobs \f[I]IN\f[] -The number of jobs to run in parallel. +The number of jobs to run in parallel (defaults to # of CPUs). .RS .RE .TP -- 2.30.2